home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994 November: Tool Chest / Dev.CD Nov 94.toast / Sample Code / Newton Sample Code 1.2 / Book Maker / BookSample-2 / README.BookSample < prev   
Encoding:
Text File  |  1994-02-28  |  3.5 KB  |  70 lines  |  [TEXT/R*ch]
  1. Making Book, a Newton Book Maker example source.  by Bob Ebert
  2. Copyright (c) 1993-1994 Apple Computer, Inc.  All rights reserved.
  3.  
  4.  
  5. This sample illustrates how to make a book using the Newton Book Maker. 
  6. It's fairly straightforward and, even, self documenting.  (The chosen book
  7. is the Newton Book Maker user's manual.)
  8.  
  9. The book source was originally written in Microsoft Word, because I like the
  10. styles support they have.  Unfortunately, a MS Word converter for the Claris
  11. XTND system may not be available to everyone, so a MacWrite II version of
  12. the book source has been included.  The MacWrite version was created by
  13. opening the MS Word version in MacWrite II, then saving it.  I never
  14. actually tested building a book from the MacWrite source... but it should
  15. work just fine.
  16.  
  17. Some caveats on building books with MS Word:
  18.  
  19.    Turn off the "Quick Save" option in Word.  Having this option on seems to
  20.    allow Word to put little pieces of garbage in between paragraphs which
  21.    confuse the book maker.  If you start seeing odd style changes in your
  22.    resulting books, it's probably because of this.
  23.    
  24.    If you do start getting odd style changes, one thing that worked for me
  25.    was to save the source document as RTF text, then re-import it into Word
  26.    as a new document and re-save it.
  27.    
  28.    Also, beware that, when changing styles in Word, the final (invisible)
  29.    paragraph mark can sometimes be in a different font or point size from
  30.    the rest of the paragraph.  This also confuses the Newton Book Maker.
  31.    
  32.    In general, best results are achieved when you start with unstyled text,
  33.    then add font, size, and style information only where needed.
  34.    
  35. Some Newton Book Maker caveats:
  36.  
  37.    Only the fonts New York and Geneva are supported.  Any other font you use
  38.    in your source book will show up in the Newton as the System Font (Which
  39.    is Espy Sans)  It's probably a good idea to avoid using this font (since
  40.    it doesn't print well), so it's worth the effort to weed out any font
  41.    besides New York and Geneva from your source book.
  42.   
  43.    Comment dot commands (.#) appear to be limited to 256 characters.  Text
  44.    beyond the 256th character is treated as a .story.  You can put multiple
  45.    .# comments on multiple lines to work around this.
  46.    
  47.    Watch out for backslashes, dot commands you want in content, etc.  Keep
  48.    in mind that the output from the Newton Book Maker is run thorugh NTK,
  49.    which also gets a stab at interpreting escape characters etc.
  50.    
  51.    Don't try to put escaped unicode characters (i.e. /u2022/u) in your book
  52.    source.  It may appear to work, but style runs will get messed up as the
  53.    Book Maker treats the above as 8 characters, even though only 1 is
  54.    produced.  [A later version of Book Maker may fix this.]
  55.    
  56. To build the book, drop the source document on the Newton Book Maker icon,
  57. then click the Do It button.  Save the result.  Add the .f file to a NTK
  58. project.  (No layout needs to be present.)  Set the Package Name in the NTK
  59. Project Settings window.  Build the project.  Download it.
  60.  
  61. NTK will close and re-open the .f file each time it builds, so once the file
  62. has been added to an NTK project there is no need to re-add it.  Just
  63. reproduce the .f output with the Newton Book Maker, save the new result over
  64. the old file (replacing it), and rebuild the project.
  65.  
  66. Finally, the Newton Book Reader (Copperfield) caches some information about
  67. each book it loads.  (The .isbn, .title, and .keywords among other things.) 
  68. If you change any of these you will need to reset the Newton to get the
  69. changes to take effect.
  70.